home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / bgecho.zip / BIGECHO.DOC < prev    next >
Text File  |  1986-09-12  |  6KB  |  122 lines
  1.  
  2.                      Documentation for BIGECHO
  3.  
  4. What it does
  5.  
  6. BIGECHO is a stand alone program which you can use at the DOS 
  7. command line and, more often, in BATch files.  To see what it can 
  8. do, run one of the two sample BATch files included in the package. 
  9. If you have an ANSI compatible screen driver installed (eg 
  10. ANSI.SYS, NANSI.SYS, FANSI-CONSOLE or TALL SCREEN) and a color 
  11. (CGA or EGA) monitor installed, run ANSIDEMO.BAT; if not, run 
  12. BIGDEMO.BAT.  These files use the public domain program WAITN by 
  13. Ken Goosens which we have borrowed and the ANSIDEMO file uses SEND 
  14. by Howard Rumsey and Barry Simon.
  15.  
  16. BIGECHO will display a message in characters 8 lines high and 8 
  17. wide.  The usage is
  18.    BIGECHO <message>[/FB]
  19. The message can be up to 10 characters in length and can contain 
  20. any character with ASCII code 127 or less except for the slash 
  21. (ASCII 92).  Any characters after the tenth are ignored and spaces 
  22. after the one required by DOS count so if you want to center 
  23. "hello!", place three blank spaces after the BIGECHO.  Some of the 
  24. control characters have interesting patterns, especially the happy 
  25. faces, ^A and ^B.
  26.  
  27. The /FB is optional.  If it is not included the default is to have 
  28. F=█ and B= <space> so that the filled in parts (Foreground) of the 
  29. character are replaced with the solid block and the empty parts 
  30. (Background) by the blank space.  In general, F and B can be any 
  31. ASCII characters.  WARNING: if you put in / with no parameters and 
  32. two or more spaces, BIGECHO interprets that as F and B being 
  33. spaces and will display blank lines. Placing / without the spaces 
  34. will cause even more undesirable behavior. 
  35.  
  36. Interesting combinations for /FB include ASCII 219,197 (/█┼) and  
  37. ASCII 206,176  (/╬░).  The ASCII table in CTRLALT is ideal for 
  38. looking at and entering higher ASCII combinations.
  39.  
  40. The file BIGECHO.SPL contains samples of the output for various 
  41. sample command lines.
  42.  
  43. BIGECHO sends its output to standard output and it can be 
  44. redirected BUT the result will probably not be what you want!  DOS 
  45. automatically wraps screen writes after 80 characters so the 640 
  46. characters produced by BIGECHO come in a stream without CR/LF 
  47. pairs.  Thus most printers will not display things properly and 
  48. redirection to a file will not display properly either.  The 
  49. sample file was produced by redirecting output and putting the 
  50. CR/LF in by hand with a word processor.
  51.  
  52.  
  53. What's included
  54.  
  55. ansidemo.bat   demonstration if you have ANSI.SYS and color monitor
  56. bigdemo .bat   demonstration otherwise
  57. bigecho .asm   source code for BIGECHO
  58. bigecho .com   the basic program
  59. bigecho .doc   this doc file
  60. bigecho .spl   samples of bigecho output
  61. goodday .asm   source for GOODDAY
  62. goodday .com   the GOODDAY program
  63. send    .com   public domain program not in the package included for demos
  64. waitn   .com   public domain program not in the package included for demos
  65.  
  66.  
  67. GOODDAY
  68.  
  69. GOODDAY is a standalone program using the same technology as 
  70. BIGECHO which responds depending on the time of day and on whether 
  71. it's Friday.  Novices seem to like it run as the last program in 
  72. their autoexec.bat.  And don't tell us that it's hardly evening at 
  73. 11:30 pm or night at 5:55 am.  We know but GOODDAY insists.
  74.  
  75.  
  76. How it works
  77.  
  78. The monochrome adapter comes with its own character ROM, that is 
  79. built in programming telling the display the dot pattern to use 
  80. for each character but the CGA does not and the dot pattern must be 
  81. contained in ROM on the computer itself.  Thus every IBM 
  82. compatible computer must have 8 by 8 dot patterns for each 
  83. character stored in its read only memory and it is this pattern 
  84. that BIGECHO accesses.  Those dots in the pattern that are 
  85. "foreground" to the adapter are replaced by character F and those 
  86. that are background are replaced by character B.  If you don't 
  87. like the pattern for some letter, don't complain to us as we 
  88. didn't pick them; complain to your computer maker!
  89.  
  90.  
  91. A Bow and Two Disclaimers
  92.  
  93.    BIGECHO was developed by Barry Simon and Richard Wilson.  
  94. GOODDAY is c(o) by Wilson.  It is POSTWARE: if you like it, send 
  95. a postcard addressed to us at 
  96.       253-37 Caltech
  97.       Pasadena, CA 91125
  98. Of course, we're glad to hear comments, suggestions about 
  99. enhancements, and even about complaints, incompatibilities and 
  100. bugs. Simon has a Compuserve number [76505,2315] .  You can leave 
  101. messages via EMAIL or, preferably, at the IBMSW Sig.  Suggestions 
  102. for enhancements would be especially welcome since we already have 
  103. some ourselves and plan a second version some time or other.  You 
  104. can find the version of BIGECHO by using the DOS command "type 
  105. BIGECHO.COM".  And if you like the program please give it to your 
  106. friends, place it on bulletin boards and otherwise spread it 
  107. around.  While it is copyright by the two of us, we explicitly 
  108. allow use of it privately and in a commercial environment.  You 
  109. may give it away but you may not charge for it or include it with 
  110. commercial software without our permission.  An exception is made 
  111. for user groups and public domain software distributors who may 
  112. include it on a disk so long as a reasonable fee is levied. 
  113.  
  114.       While we have a connection with Caltech, we emphasize that
  115. this program has no such connection.
  116.  
  117.       And we make the usual disclaimer: this software is
  118. distributed "as is" and is warranted for no purpose.  Any risk
  119. associated with its use including, but not limited to, loss of 
  120. data is borne by the user.
  121.  
  122.